home *** CD-ROM | disk | FTP | other *** search
/ iBrowse Update Disc / iBrowse Update Disc.iso / distrib / man / Manuals / Omniclient / 7_AppxA < prev    next >
Text File  |  1998-02-26  |  15KB  |  286 lines
  1. <HTML>
  2. <HEAD>
  3. <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1">
  4. <TITLE>Installing Internet</TITLE>
  5.  
  6. <META NAME="GENERATOR" CONTENT="Internet Assistant for Microsoft Word 2.04z">
  7. </HEAD>
  8. <BODY BGCOLOR="#FFFFFF">
  9. <P>
  10. <A HREF="6_filemap"><IMG SRC="pics/PREV.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  11. <A HREF="Front"><IMG SRC="pics/FRONT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  12. <A HREF="TOC"><IMG SRC="pics/CONTS.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  13. <A HREF="index"><IMG SRC="pics/INDEX.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  14. <A HREF="8_AppxB"><IMG SRC="pics/NEXT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  15. <P>
  16. <B><FONT SIZE=6>Appendix A: Installing Internet</FONT></B>
  17. <HR>
  18. <P>
  19. In the earlier chapter <A HREF="4_TCPintro">Introduction to TCP/IP</A>
  20. we outlined different ways in which you could set up OmniClient.
  21. You'll have to edit some configuration files to do so. This chapter
  22. tells you how to make those changes and install the software.
  23. It assumes you are using the desktop, and are familiar with simple
  24. use of it. If you have any problems refer to the RISC OS User
  25. Guide supplied with your RISC OS computer.
  26. <H2><A NAME="Config">Config</A>uration files</H2>
  27. <P>
  28. The configuration files that you need to edit are held within
  29. the Internet Application. Rather than refer them all the time
  30. by their lengthy full pathnames, we'll just use the leafname.
  31. The files are supplied on the Network distribution disc as:
  32. <P>
  33. <TABLE >
  34. <TR><TD WIDTH=284><B>Filename</B></TD><TD WIDTH=151><B>Leafname</B>
  35. </TD></TR>
  36. <TR><TD WIDTH=284><TT><FONT FACE="Courier">$.!Internet.files.hosts</FONT></TT> 
  37. </TD><TD WIDTH=151>hosts</TD></TR>
  38. <TR><TD WIDTH=284><TT><FONT FACE="Courier">$.!Internet.files.extensions</FONT></TT> 
  39. </TD><TD WIDTH=151>extensions</TD></TR>
  40. <TR><TD WIDTH=284><TT><FONT FACE="Courier">$.!Internet.files.mimemap</FONT></TT> 
  41. </TD><TD WIDTH=151>mimemap</TD></TR>
  42. <TR><TD WIDTH=284><TT><FONT FACE="Courier">$.!Internet.files.networks</FONT></TT> 
  43. </TD><TD WIDTH=151>networks</TD></TR>
  44. <TR><TD WIDTH=284><TT><FONT FACE="Courier">$.!Internet.files.protocols</FONT></TT> 
  45. </TD><TD WIDTH=151>protocols</TD></TR>
  46. <TR><TD WIDTH=284><TT><FONT FACE="Courier">$.!Internet.files.services</FONT></TT> 
  47. </TD><TD WIDTH=151>services</TD></TR>
  48. </TABLE>
  49. <P>
  50. The hosts, networks, protocols and services are collectively known
  51. as the databases.
  52. <H3>What the files do</H3>
  53. <UL>
  54. <LI>The <TT><FONT FACE="Courier">hosts</FONT></TT>  file gives
  55. the host names and the Internet addresses of all the computers
  56. you wish to refer to by their hostname.
  57. <LI>The <TT><FONT FACE="Courier">extensions</FONT></TT>  file allows
  58. `from' extensions to be added when converting from RISC OS to
  59. Host, and `to' extensions to be removed when converting to RISC
  60. OS from Host.
  61. <LI>The <TT><FONT FACE="Courier">mimemap</FONT></TT>  file maps
  62. the each content type to (a) particular file type(s).
  63. <LI>The <TT><FONT FACE="Courier">networks</FONT></TT> , <TT><FONT FACE="Courier">protocols</FONT></TT> 
  64. and <TT><FONT FACE="Courier">services</FONT></TT>  files contain
  65. databases of network, protocol and service names. These files
  66. are unused by the TCP/IP Protocol Suite (Release 2), and are provided
  67. to support any extra software that uses TCP/IP protocols.
  68. </UL>
  69. <P>
  70. The files specify the default values normally used on all computers
  71. that support the TCP/IP protocols; consequently, you shouldn't
  72. ever need to edit them. If you do, you should see respectively
  73. the UNIX networks, protocols, and services manual pages.
  74. <P>
  75. There are also more configuration files which can be modified
  76. and they are as follows:
  77. <P>
  78. <TABLE >
  79. <TR><TD WIDTH=312><B>Filename</B></TD><TD WIDTH=256><B>Leafname</B>
  80. </TD></TR>
  81. <TR><TD WIDTH=312><TT><FONT FACE="Courier">$.!Boot.Choices.Internet.routes</FONT></TT> 
  82. </TD><TD WIDTH=256>routes</TD></TR>
  83. <TR><TD WIDTH=312><TT><FONT FACE="Courier">$.!Boot.Choices.Internet.startup</FONT></TT> 
  84. </TD><TD WIDTH=256>startup</TD></TR>
  85. <TR><TD WIDTH=312><TT><FONT FACE="Courier">$.!Boot.Choices.Internet.user</FONT></TT> 
  86. </TD><TD WIDTH=256>user</TD></TR>
  87. </TABLE>
  88. <H3>What these files do</H3>
  89. <P>
  90. Any extra *Route commands, apart from the default route that can
  91. be set using !InetConf can be put into the routes file.
  92. <P>
  93. The user file is generated by InetSetup which includes the configurations
  94. set by the user. It shouldn't be edited by hand unless you know
  95. what you're doing.
  96. <P>
  97. Any special configuration options that cannot be set using !InetConf
  98. can be put into the startup file. It is executed immediately after
  99. the automatically generated Startup file.
  100. <H3>InetSetup Configuration </H3>
  101. <P>
  102. InetSetup does most of the configuration of the software. It sets
  103. the principal host name of a computer. It configures each interface
  104. setting their Internet addresses, their netmasks, the driver modules
  105. to be used and establishes the routing information. It also defines
  106. where to find the configuration files for the databases. Finally,
  107. it sets whether or not the station will forward packets between
  108. multiple interfaces, and hence whether it acts as a TCP/IP gateway.
  109. <H2><A NAME="Different">Different</A> ways to configure the software
  110. </H2>
  111. <P>
  112. There are some decisions you have to make on how to configure
  113. the software. This section outlines what those decisions are.
  114. For details of how to configure the choices you make, see <A HREF="#TCP">Installing the TCP/IP Protocol within OmniClient</A>,
  115. and the instructions and examples in the files you'll need to
  116. edit.
  117. <H3>Ways to set the Internet address of each interface</H3>
  118. <P>
  119. You can set the Internet address of each interface in three ways:
  120. <UL>
  121. <LI>you can set it explicitly on the computer to which it's fitted
  122. <LI>you can use the interface name to look up the Internet address
  123. in the hosts database
  124. <LI>you can use the physical address to look up the Internet address
  125. using Reverse ARP exchanges with an ARP server.
  126. </UL>
  127. <H3>Ways to establish <A NAME="routing">routing </A> information
  128. </H3>
  129. <P>
  130. If you are using gateways, you need to ensure that each RISC OS computer knows its location, and the route to subnets other
  131. than the one to which it is connected. There are three ways you
  132. can do this:
  133. <UL>
  134. <LI>Use the *Route command to explicitly define the routing of
  135. each gateway. For example:
  136. </UL>
  137. <P>
  138. <IMG SRC="pics/DIAGRAM" WIDTH=640 HEIGHT=286>
  139. <BR>
  140. <H2>Installing the <A NAME="TCP">TCP</A>/IP Protocol within OmniClient
  141. </H2>
  142. <H3>Backing up the <A NAME="distrib">distrib</A>ution discs</H3>
  143. <P>
  144. In setting up stations you'll need to alter the software<B>. You
  145. must not alter the distribution discs themselves</B>; always work
  146. on copies of them, made either on media that you can access from
  147. other computers (i.e. an Acorn file server) or that you can take
  148. to other computers (i.e. a floppy disc):
  149. <UL>
  150. <LI>If your RISC OS computers can access an Acorn file server,
  151. make a directory on the file server called (say) TCP_IP, and open
  152. its directory display. Put the Network distribution disc in the
  153. floppy drive, open its directory display, select all the files
  154. and drag them to the TCP-_IP directory display. Dismount the floppy
  155. disc. Repeat this process for the Applications distribution disc.
  156. <LI>Alternatively, use the Backup option from the floppy disc
  157. drive's icon bar menu to back up the two distribution discs to
  158. another pair of floppy discs.
  159. </UL>
  160. <H3>Where you can install the software</H3>
  161. <P>
  162. When you actually install the software for a particular station,
  163. you can do so on any media you like, such as a hard disc, floppy
  164. discs or a remote file server. All that is important is that you
  165. preserve the directory structure that is on the distribution discs
  166. - things that are in the same directory must stay together.
  167. <UL>
  168. <LI>If you're installing the software on a hard disc or an Acorn
  169. file server, we suggest you make a directory called (say) TCP_IP
  170. to hold the software. This directory can be anywhere you like
  171. - it needn't be in the root directory.
  172. <LI>You don't have to do this, and may prefer to put the software
  173. in a directory that already contains other applications.
  174. </UL>
  175. <H3>Configuring the software</H3>
  176. <P>
  177. Run !InetSetup and the required configuration changes can simply
  178. be made by following the necessary menus and entering the details
  179. as required:
  180. <UL>
  181. <LI>AUN 
  182. <LI>Access 
  183. <LI>Internet
  184. </UL>
  185. <H3>Edit the Hosts file</H3>
  186. <P>
  187. If you need to edit the hosts file this can be done through the
  188. Internet-Host names option and then double-clicking on the Hosts
  189. file.
  190. <P>
  191. Edit the file so that it contains the Internet addresses and host
  192. names of all the RISC OS computers you wish to refer to by host
  193. name. (If a computer's host name isn't in here you'll instead
  194. have to use its Internet address whenever you want to communicate).
  195. <P>
  196. If you want to add any UNIX hosts to the file, their addresses
  197. and names must match those in your UNIX /etc/hosts files. For
  198. a small number of hosts you'll probably find it best just to print
  199. out and copy a UNIX hosts file. For a larger number of hosts,
  200. you might find it better to copy across your UNIX hosts file later.
  201. <P>
  202. If you need help, see the comments in the supplied hosts file,
  203. and the UNIX hosts manual page.
  204. <P>
  205. After you have finished editing the hosts file and the required
  206. updates have been made you simply save the file so the changes
  207. can take effect.
  208. <H2>Further Reading</H2>
  209. <P>
  210. The following variables are used to configure the software but
  211. are for further reading purposes only:
  212. <P>
  213. <TABLE >
  214. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><B>Variable</B></TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360><B>Notes</B>
  215. </TD></TR>
  216. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$EaCount</FONT></TT> 
  217. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets the number of Ethernet cards present
  218. </TD></TR>
  219. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$Email</FONT></TT> 
  220. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets the email address associated with the machine.
  221. </TD></TR>
  222. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$EtherDevice</FONT></TT> 
  223. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets the driver module to be used to interface the TCP/IP software with your Ethernet interface
  224. </TD></TR>
  225. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$EtherIPAddr</FONT></TT> 
  226. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets whether your station has an Ethernet interface that you wish to configure for use with TCP/IP, and (if so) sets the Internet address, or specifies that it be looked up using Reverse ARP.
  227. </TD></TR>
  228. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$EtherIPMas</FONT></TT> 
  229. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets the netmask for an Ethernet interface; the default is correct for most cases.
  230. </TD></TR>
  231. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$EtherType</FONT></TT> 
  232. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets the type of Ethernet device used.
  233. </TD></TR>
  234. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$HostName</FONT></TT> 
  235. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets a station's principal hot name
  236. </TD></TR>
  237. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$IsGateway</FONT></TT> 
  238. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets whether the machine is to forward IP packets, and hence whether it will act as a <A NAME="gateway">gateway</A>.
  239. </TD></TR>
  240. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$LocalAddr</FONT></TT> 
  241. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets the local address of the machine.
  242. </TD></TR>
  243. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$LocalDomain</FONT></TT> 
  244. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets the local domain of the machine.
  245. </TD></TR>
  246. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$MimeMappings</FONT></TT> 
  247. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets the mapping of content types to file types.
  248. </TD></TR>
  249. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$Path</FONT></TT> 
  250. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets the pathname of the directory containing the Internet application.
  251. </TD></TR>
  252. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$Resolvers</FONT></TT> 
  253. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets the Internet resolver module IP addresses.
  254. </TD></TR>
  255. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$RouteDOptions</FONT></TT> 
  256. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets whether RouteD - the Internet routing module - is run and (if so) with what options.
  257. </TD></TR>
  258. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$Started</FONT></TT> 
  259. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets whether the Internet application has started or not.
  260. </TD></TR>
  261. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">Inet$Startup</FONT></TT> 
  262. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets the pathname for the startup file.
  263. </TD></TR>
  264. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">InetDBase$Path</FONT></TT> 
  265. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets the pathname of the directory containing the database files.
  266. </TD></TR>
  267. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">InetLogs$Path</FONT></TT> 
  268. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets the pathname of a directory containing the logs file.
  269. </TD></TR>
  270. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">InetSetup$Dir</FONT></TT> 
  271. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets the directory of the inetsetup file.
  272. </TD></TR>
  273. <TR><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=208><TT><FONT FACE="Courier">InetSpool$Path</FONT></TT> 
  274. </TD><TD ALIGN="LEFT" VALIGN="TOP" WIDTH=360>This sets the pathname of the directory containing the spool file.
  275. </TD></TR>
  276. </TABLE>
  277. <P>
  278. <A HREF="6_filemap"><IMG SRC="pics/PREV.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  279. <A HREF="Front"><IMG SRC="pics/FRONT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  280. <A HREF="TOC"><IMG SRC="pics/CONTS.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  281. <A HREF="index"><IMG SRC="pics/INDEX.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  282. <A HREF="8_AppxB"><IMG SRC="pics/NEXT.GIF" HEIGHT="28" WIDTH="96" BORDER="0"></A>
  283. <P>
  284. </BODY>
  285. </HTML>
  286.